package com.bookocean.domain.service;

import com.bookocean.controller.dto.NovelDto;
import com.bookocean.controller.dto.NovelChapterDto;
import com.bookocean.controller.dto.NovelParticipantDto;

import java.util.List;

/**
 * 小说领域服务接口
 * 
 * @author BookOcean
 * @since 2024-01-01
 */
public interface NovelDomainService {
    
    /**
     * 创建小说
     * 
     * @param novelDto 小说信息
     * @return 创建后的小说信息
     */
    NovelDto createNovel(NovelDto novelDto);
    
    /**
     * 根据ID查询小说基本信息
     * 
     * @param novelId 小说ID
     * @return 小说信息
     */
    NovelDto getNovelById(Long novelId);
    
    /**
     * 根据ID查询小说详细信息（包含统计数据和用户交互状态）
     * 
     * @param novelId 小说ID
     * @param userId 当前用户ID（用于查询用户交互状态，可为null）
     * @return 详细小说信息
     */
    NovelDto getEnhancedNovelById(Long novelId, Long userId);
    
    /**
     * 更新小说信息
     * 
     * @param novelDto 小说信息
     * @return 更新后的小说信息
     */
    NovelDto updateNovel(NovelDto novelDto);
    
    /**
     * 完结小说
     * 
     * @param novelId 小说ID
     * @param userId 操作用户ID
     * @return 更新后的小说信息
     */
    NovelDto completeNovel(Long novelId, Long userId);
    
    /**
     * 分页查询用户参与的小说列表
     * 
     * @param userId 用户ID
     * @param page 页码
     * @param pageSize 每页数量
     * @return 小说列表
     */
    List<NovelDto> getUserParticipatedNovels(Long userId, Integer page, Integer pageSize);
    
    /**
     * 分页查询正在招募的小说列表
     * 
     * @param page 页码
     * @param pageSize 每页数量
     * @return 小说列表
     */
    List<NovelDto> getRecruitingNovels(Integer page, Integer pageSize);
    
    /**
     * 分页查询已完结小说列表（按热度排序）
     * 
     * @param page 页码
     * @param pageSize 每页数量
     * @return 小说列表
     */
    List<NovelDto> getCompletedNovels(Integer page, Integer pageSize);
    
    /**
     * 加入小说创作
     * 
     * @param novelId 小说ID
     * @param userId 用户ID
     * @return 参与者信息
     */
    NovelParticipantDto joinNovel(Long novelId, Long userId);
    
    /**
     * 查询小说参与者列表
     * 
     * @param novelId 小说ID
     * @return 参与者列表
     */
    List<NovelParticipantDto> getNovelParticipants(Long novelId);
    
    /**
     * 写新章节
     * 
     * @param chapterDto 章节信息
     * @return 章节信息
     */
    NovelChapterDto writeChapter(NovelChapterDto chapterDto);
    
    /**
     * 查询小说章节列表
     * 
     * @param novelId 小说ID
     * @return 章节列表
     */
    List<NovelChapterDto> getNovelChapters(Long novelId);
    
    /**
     * 查询小说章节详细信息（包含统计数据和用户交互状态）
     * 
     * @param chapterId 章节ID
     * @param userId 当前用户ID（用于查询用户交互状态，可为null）
     * @return 章节详细信息
     */
    NovelChapterDto getEnhancedChapterById(Long chapterId, Long userId);
    
    /**
     * 检查用户是否可以写下一章
     * 
     * @param novelId 小说ID
     * @param userId 用户ID
     * @return 是否可以写作
     */
    boolean canWriteNextChapter(Long novelId, Long userId);
}
